---
id: get-namespaces
title: "List all namespaces"
description: "Returns a list of namespaces."
sidebar_label: "List all namespaces"
hide_title: true
hide_table_of_contents: true
api:
  {
    "operationId": "getNamespaces",
    "parameters":
      [
        {
          "name": "limit",
          "in": "query",
          "description": "The number of results to return from offset.",
          "required": false,
          "schema": { "type": "integer", "example": 25, "default": 100 },
        },
        {
          "name": "offset",
          "in": "query",
          "description": "The initial position from which to return results.",
          "required": false,
          "schema": { "type": "integer", "default": 0 },
        },
      ],
    "description": "Returns a list of namespaces.",
    "tags": ["Namespaces"],
    "responses":
      {
        "200":
          {
            "description": "OK",
            "content":
              {
                "application/json":
                  {
                    "schema":
                      {
                        "type": "object",
                        "properties":
                          {
                            "namespaces":
                              {
                                "type": "array",
                                "items":
                                  {
                                    "type": "object",
                                    "properties":
                                      {
                                        "name":
                                          {
                                            "description": "The name of the namespace.",
                                            "type": "string",
                                          },
                                        "createdAt":
                                          {
                                            "description": "An [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp representing the date/time the namespace was created.",
                                            "type": "string",
                                            "format": "date-time",
                                          },
                                        "updatedAt":
                                          {
                                            "description": "An [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp representing the date/time the namespace was updated.",
                                            "type": "string",
                                            "format": "date-time",
                                          },
                                        "ownerName":
                                          {
                                            "description": "The owner of the namespace.",
                                            "type": "string",
                                          },
                                        "description":
                                          {
                                            "description": "The description of the namespace.",
                                            "type": "string",
                                          },
                                      },
                                    "example":
                                      {
                                        "name": "my-namespace",
                                        "createdAt": "2019-05-09T19:49:24.201361Z",
                                        "updatedAt": "2019-05-09T19:49:24.201361Z",
                                        "ownerName": "me",
                                        "description": "My first namespace!",
                                      },
                                    "title": "Namespace",
                                  },
                              },
                          },
                        "title": "NamespaceList",
                      },
                  },
              },
          },
      },
    "method": "get",
    "path": "/namespaces",
    "servers":
      [
        {
          "url": "http://localhost:5000/api/v1",
          "description": "Local API server",
        },
      ],
    "info":
      {
        "title": "Marquez",
        "version": "0.50.0",
        "description": "Marquez is an open source **metadata service** for the **collection**, **aggregation**, and **visualization** of a data ecosystem's metadata.",
        "license":
          {
            "name": "Apache 2.0",
            "url": "http://www.apache.org/licenses/LICENSE-2.0.html",
          },
      },
    "postman":
      {
        "name": "List all namespaces",
        "description":
          { "content": "Returns a list of namespaces.", "type": "text/plain" },
        "url":
          {
            "path": ["namespaces"],
            "host": ["{{baseUrl}}"],
            "query":
              [
                {
                  "disabled": false,
                  "description":
                    {
                      "content": "The number of results to return from offset.",
                      "type": "text/plain",
                    },
                  "key": "limit",
                  "value": "",
                },
                {
                  "disabled": false,
                  "description":
                    {
                      "content": "The initial position from which to return results.",
                      "type": "text/plain",
                    },
                  "key": "offset",
                  "value": "",
                },
              ],
            "variable": [],
          },
        "header": [{ "key": "Accept", "value": "application/json" }],
        "method": "GET",
      },
  }
sidebar_class_name: "get api-method"
info_path: docs/api/marquez
custom_edit_url: null
---

import ApiTabs from "@theme/ApiTabs";
import MimeTabs from "@theme/MimeTabs";
import ParamsItem from "@theme/ParamsItem";
import ResponseSamples from "@theme/ResponseSamples";
import SchemaItem from "@theme/SchemaItem";
import SchemaTabs from "@theme/SchemaTabs";
import DiscriminatorTabs from "@theme/DiscriminatorTabs";
import TabItem from "@theme/TabItem";

## List all namespaces

Returns a list of namespaces.

<details style={{"marginBottom":"1rem"}} data-collapsed={false} open={true}><summary style={{}}><strong>Query Parameters</strong></summary><div><ul><ParamsItem className={"paramsItem"} param={{"name":"limit","in":"query","description":"The number of results to return from offset.","required":false,"schema":{"type":"integer","example":25,"default":100}}}></ParamsItem><ParamsItem className={"paramsItem"} param={{"name":"offset","in":"query","description":"The initial position from which to return results.","required":false,"schema":{"type":"integer","default":0}}}></ParamsItem></ul></div></details><div><ApiTabs><TabItem label={"200"} value={"200"}><div>

OK

</div><div><MimeTabs schemaType={"response"}><TabItem label={"application/json"} value={"application/json"}><SchemaTabs><TabItem label={"Schema"} value={"Schema"}><details style={{}} data-collapsed={false} open={true}><summary style={{"textAlign":"left"}}><strong>Schema</strong></summary><div style={{"textAlign":"left","marginLeft":"1rem"}}></div><ul style={{"marginLeft":"1rem"}}><SchemaItem collapsible={true} className={"schemaItem"}><details style={{}}><summary style={{}}><strong>namespaces</strong><span style={{"opacity":"0.6"}}> object[]</span></summary><div style={{"marginLeft":"1rem"}}><li><div style={{"fontSize":"var(--ifm-code-font-size)","opacity":"0.6","marginLeft":"-.5rem","paddingBottom":".5rem"}}>Array [</div></li><SchemaItem collapsible={false} name={"name"} required={false} schemaName={"string"} qualifierMessage={undefined} schema={{"description":"The name of the namespace.","type":"string"}}></SchemaItem><SchemaItem collapsible={false} name={"createdAt"} required={false} schemaName={"date-time"} qualifierMessage={undefined} schema={{"description":"An [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp representing the date/time the namespace was created.","type":"string","format":"date-time"}}></SchemaItem><SchemaItem collapsible={false} name={"updatedAt"} required={false} schemaName={"date-time"} qualifierMessage={undefined} schema={{"description":"An [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp representing the date/time the namespace was updated.","type":"string","format":"date-time"}}></SchemaItem><SchemaItem collapsible={false} name={"ownerName"} required={false} schemaName={"string"} qualifierMessage={undefined} schema={{"description":"The owner of the namespace.","type":"string"}}></SchemaItem><SchemaItem collapsible={false} name={"description"} required={false} schemaName={"string"} qualifierMessage={undefined} schema={{"description":"The description of the namespace.","type":"string"}}></SchemaItem><li><div style={{"fontSize":"var(--ifm-code-font-size)","opacity":"0.6","marginLeft":"-.5rem"}}>]</div></li></div></details></SchemaItem></ul></details></TabItem><TabItem label={"Example (from schema)"} value={"Example (from schema)"}><ResponseSamples responseExample={"{\n  \"namespaces\": [\n    {\n      \"name\": \"my-namespace\",\n      \"createdAt\": \"2019-05-09T19:49:24.201361Z\",\n      \"updatedAt\": \"2019-05-09T19:49:24.201361Z\",\n      \"ownerName\": \"me\",\n      \"description\": \"My first namespace!\"\n    }\n  ]\n}"} language={"json"}></ResponseSamples></TabItem></SchemaTabs></TabItem></MimeTabs></div></TabItem></ApiTabs></div>

